home *** CD-ROM | disk | FTP | other *** search
/ Games of Daze / Infomagic - Games of Daze (Summer 1995) (Disc 1 of 2).iso / x2ftp / msdos / utils / gredarc / gredaman.txt < prev    next >
Text File  |  1993-03-08  |  39KB  |  922 lines
  1.  
  2.  
  3.  
  4.  
  5.                                    GREDA
  6.  
  7.                         Graphics Editor and Animator
  8.                                 Version 1.00
  9.  
  10.  
  11.                                 User's Guide
  12.  
  13.  
  14.                     Copyright (c) 1993 - Robert Dobbins
  15.                             All Rights Reserved
  16.  
  17.  
  18.                               Shareware Version
  19.  
  20.  
  21. ────────────────────────────────────────────────────────────────────────────
  22. Table of Contents
  23. ────────────────────────────────────────────────────────────────────────────
  24.  
  25. Introduction ................................................... 1
  26. Installation ................................................... 1
  27. Hardware and Software Requirements ............................. 2
  28. Using GREDA .................................................... 2
  29. General Behavior ............................................... 3
  30. Configuring GREDA .............................................. 4
  31. Screen Layout .................................................. 5
  32. Menu Tree ...................................................... 6
  33. Creating an Image File ......................................... 9
  34. Editing an Image File .......................................... 9
  35. Saving an Image File .......................................... 10
  36. File Buttons .................................................. 10
  37. Menu Buttons .................................................. 10
  38. Color Buttons ................................................. 12
  39. Image Positioning ............................................. 12
  40. Color Palette Editor .......................................... 13
  41. Acknowledgements .............................................. 16
  42.  
  43.  
  44. GREDA User's Guide                                          Page: 1
  45.  
  46. ────────────────────────────────────────────────────────────────────────────
  47. Introduction
  48. ────────────────────────────────────────────────────────────────────────────
  49.  
  50. GREDA was designed for the development of sprites, backgrounds, and animated 
  51. sequences using the VGA (video graphics array) 320x200, 256-color mode.  The 
  52. program employs a graphical user interface (GUI) to invoke menu selections.  
  53. The user will move the mouse cursor to a menu item and click the left button 
  54. of the mouse to select.
  55.  
  56. Each graphics image or animated sequence is stored in a file on the 
  57. computer's disk.  Animated sequences are stored sequentially in the file as 
  58. a database.  Each image is called a frame, and each frame will use the same 
  59. height and width as originally defined by the user.
  60.  
  61. These animated sequences and backgrounds may be used later to develop games 
  62. that use the VGA 256-color mode.  GREDA comes with some sample C source code 
  63. to display and move these images around on the display.  The file formats 
  64. are revealed in that code.
  65.  
  66. ────────────────────────────────────────────────────────────────────────────
  67. Installation
  68. ────────────────────────────────────────────────────────────────────────────
  69.  
  70. GREDA and its associated files will take up about 1.2Mb on the average hard 
  71. disk drive (32Mb).  This amount may vary according to the particular drive 
  72. type.
  73.  
  74. To install GREDA, make a directory on your hard disk drive:
  75. MD \GREDA ──┘
  76.  
  77. Change to that directory:
  78. CD \GREDA ──┘
  79.  
  80. Copy the self-extracting archived file GREDARC.EXE to the directory:
  81. COPY A:\GREDARC.EXE ──┘
  82.  
  83. Type the name of that file at the DOS prompt:
  84. GREDARC ──┘
  85.  
  86. The self-extracting file will create the following files:
  87.  
  88.    GREDA.EXE - Graphics editor and animator.
  89.    GREDA.CFG - GREDA configuration file.
  90.    GREDA.PAL - Sample color palette.
  91.     HELV.008 - Helvetica style font, 8-high.
  92.     HELV.014 - Helvetica style font, 14-high.
  93.     HELV.016 - Helvetica style font, 16-high.
  94.     HELV.019 - Helvetica style font, 19-high.
  95. GREDAMAN.TXT - This User's Guide.
  96.   RODENT.GGF - Greda graphics file of mouse.
  97.   RODENT.PAL - Greda color palette for RODENT.
  98.    MACAW.GGF - Macaw converted from PIC.
  99.    MACAW.PAL - Color palette for MACAW.
  100.  CHEETAH.GGF - Cheetah converted from PIC.
  101.  CHEETAH.PAL - Color palette for CHEETAH.
  102.    TEST2.GGF - Sample hand-drawn screen.
  103. GREDA User's Guide                                          Page: 2
  104.  
  105.    TEST2.PAL - Color palette for TEST2.
  106.     FALL.GGF - Converted from PIC.
  107.     FALL.PAL - Color palette for FALL.
  108.    CLOWN.GGF - Clown converted from PIC.
  109.    CLOWN.PAL - Color palette for CLOWN.
  110.    PEPSI.GGF - Pepsi can converted from GIF.
  111.    PEPSI.PAL - Color palette for PEPSI.
  112.   SAMPLE.EXE - Sample developed with GREDA and associated files.
  113.     SAMPLE.C - Source code for sample.
  114.   SAMPLE.LNK - Link response file for sample.
  115.        VGA.H - Header file for GREDA library (GIDL.LIB).
  116.     GIDL.LIB - GREDA Image Display (large model) library.
  117.   SAMPLE.PAL - Color palette for sample.
  118.      BOY.GGF - Graphics animation file for sample.
  119.     BOY2.GGF - Graphics animation file for sample.
  120.     GIRL.GGF - Graphics animation file for sample.
  121.    GIRL2.GGF - Graphics animation file for sample.
  122.    STAGE.GGF - Graphics background for sample.
  123.  
  124. ────────────────────────────────────────────────────────────────────────────
  125. Hardware and Software Requirements
  126. ────────────────────────────────────────────────────────────────────────────
  127.  
  128. GREDA requires version 3.20 or higher version of MS- or PC-DOS, an IBM or 
  129. compatible computer with a VGA adapter, a Microsoft or compatible 2-button 
  130. mouse, and 420k of available memory.  GREDA works best with a hard disk 
  131. drive and disk caching, which improves file save/retrieve performance and a 
  132. computer using VESA bus architecture which greatly improves the video 
  133. performance.
  134.  
  135. GREDA has been tested on IBM model 50,60,70, and 80, and a Gateway 2000 with 
  136. 500 Mb hard drive and VESA bus.  GREDA was found to work flawlessly using 
  137. these systems.  If the user has any trouble with this software they are 
  138. encouraged to notify the developer.
  139.  
  140. ────────────────────────────────────────────────────────────────────────────
  141. Using GREDA
  142. ────────────────────────────────────────────────────────────────────────────
  143.  
  144. To run GREDA, from the DOS prompt change to the directory where the program 
  145. resides:
  146.  
  147. CD \GREDA ───┘
  148.  
  149. Then invoke the program by type the name and pressing the enter key:
  150.  
  151. GREDA ───┘
  152.  
  153. GREDA responds to the following command line arguments:
  154.  
  155. /? - Displays information about the program.
  156. /S - Skips the program logo.
  157. /I - Skips the program logo.
  158. /P - Displays the shareware product information.
  159.  
  160.  
  161. GREDA User's Guide                                          Page: 3
  162.  
  163. After initializing the mouse driver, GREDA will display the logo screen.  
  164. After about 20 seconds, the program will display the image editor.
  165.  
  166. GREDA uses selection buttons by which the user will invoke menu selections.  
  167. To invoke a selection, the user must move the mouse cursor onto the item and 
  168. click the left button on the mouse.  The program will display the button as 
  169. pressed (shift right and down one pixel) until the user releases the mouse 
  170. button.
  171.  
  172. ────────────────────────────────────────────────────────────────────────────
  173. General Behavior
  174. ────────────────────────────────────────────────────────────────────────────
  175.  
  176. The program has been designed such that certain keyboard and mouse 
  177. operations will be interpreted in a consistent manner.  Following is a list 
  178. of these behaviors:
  179.  
  180. Mouse:
  181.  
  182.   Left Button - Select, place color onto image.
  183.  
  184.  Right Button - Cancel or [Esc] from menus.
  185.                 Picks up current color from an image.
  186.                 Restores color in color palette editor.
  187.  
  188.  Mouse Cursor - When the mouse cursor is in the image area, the program
  189.                 will display the mouse cursor in some unique and
  190.                 identifiable shape other than the arrow.
  191.  
  192.                 When the mouse cursor is not in the image area, it will be
  193.                 displayed in the shape of an arrow.
  194.  
  195. Key Strokes:
  196.  
  197.         [Esc] - Cancel
  198.         [Ins] - Toggle insert/overstrike mode
  199.         [Del] - Delete character at cursor
  200.        [BkSp] - Delete character left of cursor
  201.        [Home] - Move cursor to beginning of line
  202.         [End] - Move cursor to end of line
  203.  [Ctrl]+[End] - Delete characters from cursor to end of line
  204.          ──┘ - Accept entry
  205.          [-] - Cursor left
  206.          [-] - Cursor right
  207.         [Tab] - Tab right
  208. [Shift]+[Tab] - Tab left
  209.  
  210.   Text Cursor - When the program is waiting for user data entry, the
  211.                 underline cursor will indicate overstrike typing. The block
  212.                 cursor will indicate insert typing.
  213.  
  214. GREDA User's Guide                                          Page: 4
  215.  
  216. ────────────────────────────────────────────────────────────────────────────
  217. Configuring GREDA
  218. ────────────────────────────────────────────────────────────────────────────
  219.  
  220.         ┌────────────────────────────────────┐
  221.         │         Horiz Mickeys: ░░░         │
  222.         │                                    │
  223.         │          Vert Mickeys: ░░░         │
  224.         │                                    │
  225.         │       Speed Threshold: ░░░         │
  226.         │                                    │
  227.         │      Default File Ext: ░░░         │
  228.         │                                    │
  229.         │        Auto Save? Y/N: ░           │
  230.         │                                    │
  231.         │     Auto Palette? Y/N: ░           │
  232.         └────────────────────────────────────┘
  233.  
  234. ┌───────────────────┐
  235. │Horiz Mickeys      │
  236. └───────────────────┘
  237.  
  238. This sets the horizontal relationship between the mouse device movement and 
  239. the mouse cursor on the display.
  240.  
  241. ┌───────────────────┐
  242. │Vert Mickeys       │
  243. └───────────────────┘
  244.  
  245. This sets the vertical relationship between the mouse device movement and 
  246. the mouse cursor on the display.
  247.  
  248. ┌───────────────────┐
  249. │Speed Threshold    │
  250. └───────────────────┘
  251.  
  252. This defines the point at which the mouse driver initiates double-speed 
  253. movement of the mouse cursor.
  254.  
  255. ┌───────────────────┐
  256. │Default File Ext   │
  257. └───────────────────┘
  258.  
  259. This is the default file extension for graphics image files.  The as-shipped 
  260. default is ".GGF" (Greda Graphics File).
  261.  
  262. ┌───────────────────┐
  263. │Auto Save? Y/N     │
  264. └───────────────────┘
  265.  
  266. When this option is set to 'Y', the program will automatically save images 
  267. to disk when changes have been made and the user invokes any function that 
  268. will reposition the database, loads another file, or quits the application.  
  269. When this option is set to 'N', the program will prompt the user to save the 
  270. image to file.
  271.  
  272. GREDA User's Guide                                          Page: 5
  273.  
  274. ┌───────────────────┐
  275. │Auto Palette? Y/N  │
  276. └───────────────────┘
  277.  
  278. If the user designs a color palette specifically for an image file, the user 
  279. should name that file by the same name (other than file extension) as the 
  280. image file (i.e. CHEETAH.GGF and CHEETAH.PAL).  If the user sets this 
  281. configuration option to 'Y', then GREDA will automatically load color 
  282. palettes with the same filename.
  283.  
  284. ────────────────────────────────────────────────────────────────────────────
  285. Screen Layout
  286. ────────────────────────────────────────────────────────────────────────────
  287.  
  288. Following is textual representation of the GREDA display.  Each button has 
  289. been labeled with a number and is defined in the next "Menu Tree" section.
  290.  
  291. ┌─────────────────────────────┬──────┬──────┬──────┬──────┬────────────────┐
  292. │1.                           │2.    │3.    │4.    │5.    │6.              │
  293. │File:                        │  <<  │  <-  │  ->  │  >>  │ No             │
  294. ├──────┬──────┬───────────────┴──────┴──────┴──────┴──────┴───────────┬────┤
  295. │7.    │8.    │                                                       │35. │
  296. │   ?  │      │  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  │    │
  297. │      │      │  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  │    │
  298. ├──────┼──────┤  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  ├────┤
  299. │9.    │10.   │  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  │36. │
  300. │      │      │  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  │    │
  301. │      │      │  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  │   │
  302. ├──────┼──────┤  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  ├────┤
  303. │11.   │12.   │  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  │37. │
  304. │      │      │  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  │    │
  305. │      │      │  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  │    │
  306. ├──────┼──────┤  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  │    │
  307. │13.   │14.   │  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  │    │
  308. │      │      │  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  │    │
  309. │      │      │  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  │    │
  310. ├──────┼──────┤  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  │    │
  311. │15.   │16.   │  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  │    │
  312. │      │      │  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  │    │
  313. │      │      │  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  │    │
  314. ├──────┼──────┤  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  │    │
  315. │17.   │18.   │  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  │    │
  316. │      │      │  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  ├────┤
  317. │      │      │  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  │38. │
  318. ├──────┼──────┤  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  │    │
  319. │19.   │20.   │  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  │   │
  320. │      │      │  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  ├────┤
  321. │      │      │  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  │39. │
  322. ├──────┼──────┤  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  │    │
  323. │21.   │22.   │                                                       │    │
  324. │      │      ├───────┬───────┬────────────────────────────┬───────┬──┴────┤
  325. │      │      │30. << │31. <- │32.                         │33. -> │34. >> │
  326. ├──────┼──────┼───────┼───────┴────────────────────────────┴───────┼───────┤
  327. │23.   │24.   │25. <- │27.                                         │28. -> │
  328. │   S  │   C  ├───────┤ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ ├───────┤
  329. │      │      │26. << │                                            │29. >> │
  330. └──────┴──────┴───────┴────────────────────────────────────────────┴───────┘
  331. GREDA User's Guide                                          Page: 6
  332.  
  333.  
  334. ────────────────────────────────────────────────────────────────────────────
  335. Menu Tree
  336. ────────────────────────────────────────────────────────────────────────────
  337.  
  338. Following is the image editor menu tree.  Each menu item begins with the 
  339. number associated with its position on the display in the previous "Screen 
  340. Layout" section.  Like items are grouped into sections and labeled by the 
  341. boxed titles:
  342.  
  343. ┌───────────────────────────┐
  344. │File Buttons               │
  345. └───────────────────────────┘
  346.  
  347.  1 - File Open/Create
  348.  2 - First Image Record
  349.  3 - Previous Image Record
  350.  4 - Next Image Record
  351.  5 - Last Image Record
  352.  6 - Current Image Record Number
  353.  
  354. ┌───────────────────────────┐
  355. │Menu Buttons               │
  356. └───────────────────────────┘
  357.  
  358.  7 - Help
  359.  8 - Record
  360.         Retrieve Current Record
  361.         Save Current Record
  362.         Insert Before Record
  363.         Delete Current Record
  364.  9 - Pen
  365.         Height
  366.         Width
  367. 10 - Text
  368.         8, 14, 16, or 19 Pixel High Font
  369.             Normal Text
  370.             Color Phase Increase
  371.             Color Phase Decrease
  372.             Text With Shadow
  373.             Color Phase Increase & Shadow
  374.             Color Phase Decrease & Shadow
  375. 11 - Shapes
  376.         Line Draw
  377.         Rectangle
  378.             Outline
  379.             Fill
  380.             Color Phase
  381.             Brownian Horizontal
  382.             Brownian Vertical
  383.         Ellipse
  384.             Outline
  385.             Fill
  386.             Color Phase Center->Out
  387.             Color Phase Border->In
  388.             Starburst
  389. GREDA User's Guide                                          Page: 7
  390.  
  391.         Polygon
  392.             Outline
  393.             Fill
  394.             Color Phase Center->Out
  395.             Color Phase Border->In
  396. 12 - Spray
  397.         Height
  398.         Width
  399.         DPS
  400. 13 - Color Palette
  401.         Edit Palette
  402.             Trend Start
  403.             Trend Stop
  404.             Generate Trend
  405.             Restore Colors
  406.             Keep
  407.             Cancel
  408.         Save Palette
  409.         Load Palette
  410. 14 - Region Fill
  411.         Fill With Color
  412.         Fill With Copy Buffer
  413.         Fill With Scheme
  414.         Step & Repeat Copy Buffer
  415.         Step & Repeat Scheme Buffer
  416.         Load Scheme Buffer From File
  417.         Release Scheme Buffer Memory
  418. 15 - Size, Rotation, Flip
  419.         Resize
  420.         Auto Minimize
  421.         Flip Vertically
  422.         Flip Horizontally
  423.         Rotate Left
  424.         Rotate Right
  425. 16 - Move Image Area
  426.         Up
  427.         Down
  428.         Left
  429.         Right
  430.         Keep
  431.         Abandon
  432. 17 - Magnification
  433.         Normal Size
  434.         Double Size
  435.         Quadruple Size
  436. 18 - Tools
  437.         Configure GREDA
  438.             Horiz Mickeys
  439.             Vert Mickeys
  440.             Speed Threshold
  441.             Default File Ext
  442.             Auto Save? Y/N
  443.             Auto Palette? Y/N
  444.         Available Memory
  445.         Search & Replace Color
  446.         Fill Image With Color
  447.         Erase Image Frame
  448. GREDA User's Guide                                          Page: 8
  449.  
  450.         Export Functions
  451.             Data File
  452.             Mouse Pointer File
  453.             Color Palette File
  454.         Release Copy Buffer
  455.         Release Scheme Buffer
  456. 19 - Replay
  457.         Repeat
  458.         FPS
  459.         Method (L, B, S)
  460. 20 - Block Menu
  461.         Block Functions
  462.             Copy
  463.             Erase
  464.             Fill
  465.             Move
  466.             Color Phase
  467.                 Increase Left->Right
  468.                 Increase Right->Left
  469.                 Increase Top->Bottom
  470.                 Increase Bottom->Top
  471.             Search & Replace
  472.             Extract to Scheme File
  473.             Extract to Image File
  474.             Horizontal Random Shift
  475.             Vertical Random Shift
  476.         Replace Area With Copy Buffer
  477.         OR Area With Copy Buffer
  478.         AND Area With Copy Buffer
  479.         Load Copy Buffer From File
  480.         Release Copy Buffer Memory
  481. 21 - View
  482.         Load Screen Image
  483.         Erase Screen Image
  484.         View Current Frame
  485. 22 - Exit
  486.         Yes/No
  487.  
  488. ┌───────────────────────────┐
  489. │Color Buttons              │
  490. └───────────────────────────┘
  491.  
  492. 23 - Search Color
  493. 24 - Current Color
  494. 25 - Previous 8 colors
  495. 26 - First 56 Colors
  496. 27 - 56 of 256 Available Colors
  497. 28 - Next 8 Colors
  498. 29 - Last 56 Colors
  499.  
  500. ┌───────────────────────────┐
  501. │Image Buttons Horizontal   │
  502. └───────────────────────────┘
  503.  
  504. These buttons will appear only when an image is loaded and the image width 
  505. is greater than 272.  If the image height > 152, then these buttons will 
  506. appear when the image width is greater than 262.
  507. GREDA User's Guide                                          Page: 9
  508.  
  509.  
  510. 30 - Display Left Most Part of Image
  511. 31 - Shift Image Left 8 Pixels
  512. 32 - Nothing
  513. 33 - Shift Image Right 8 Pixels
  514. 34 - Display Right Most Part of Image
  515.  
  516. ┌───────────────────────────┐
  517. │Image Buttons Vertical     │
  518. └───────────────────────────┘
  519.  
  520. These buttons will appear only when an image is loaded and the image height 
  521. is greater than 152.  If the image width is greater than 272, then these 
  522. buttons will appear when the image height is greater 142.
  523.  
  524. 35 - Display Top Most Part of Image
  525. 36 - Shift Image Up 8 Pixels
  526. 37 - Nothing
  527. 38 - Shift Image Down 8 Pixels
  528. 39 - Display Bottom Most Part of Image
  529.  
  530. ────────────────────────────────────────────────────────────────────────────
  531. Creating an Image File
  532. ────────────────────────────────────────────────────────────────────────────
  533.  
  534. To create a new graphics image, the user must first click the left mouse 
  535. button on the FILE selection button (1).  The program will display the 
  536. button pressed until the user releases the mouse button.  A cursor will 
  537. appear in the file button window and the user should enter the name of the 
  538. file.  A file extension will be appended if the user does not enter one and 
  539. the configuration specifies a default one.
  540.  
  541. While entering data into these fields, the user may abandon by either 
  542. pressing the escape key ([Esc]) or pressing the right button on the mouse.
  543.  
  544. After entering the new filename, GREDA will try to find one on the disk.  If 
  545. the file does not exist, the program will request approval to create the new 
  546. file.  After answering 'Y', the user will be prompted to define the height 
  547. and width of the image.
  548.  
  549. The maximum height of any image is 200 and the maximum width is 320.  Images 
  550. cannot be defined as smaller than 1 in height or width.
  551.  
  552. After entering this information, GREDA will create the new file with a blank 
  553. image and set the record counter to 1.  The user may select a drawing device 
  554. and begin painting the image.
  555.  
  556. ────────────────────────────────────────────────────────────────────────────
  557. Editing an Image File
  558. ────────────────────────────────────────────────────────────────────────────
  559.  
  560. To edit an existing graphics image, the user must first click the left mouse 
  561. button on the FILE selection button (1).  The program will display the 
  562. button pressed until the user releases the mouse button.  A cursor will 
  563. appear in the file button window and the user should enter the name of the 
  564. file.  A file extension will be appended if the user does not enter one and 
  565. the configuration specifies a default one.
  566. GREDA User's Guide                                          Page: 10
  567.  
  568.  
  569. The user may enter a DOS wild-card specification (i.e. *.GGF) and press the 
  570. enter key.  GREDA will display the list of files that were found to meet 
  571. that specification.  The user may select from that list by moving the mouse 
  572. cursor to the row of the file name and clicking the left button on the 
  573. mouse.
  574.  
  575. If the file exists, the program will open the file, display the first frame, 
  576. and set the record counter to 1.  The user may select a drawing device and 
  577. begin editing the image.
  578.  
  579. ────────────────────────────────────────────────────────────────────────────
  580. Saving an Image File
  581. ────────────────────────────────────────────────────────────────────────────
  582.  
  583. To save the image to file, the user can move the mouse cursor to the record 
  584. menu item (8) and click the left mouse button.  The program will display a 
  585. menu of choices.  Click on the item labeled "Save Current Record".  The 
  586. program will write the image to disk.
  587.  
  588. If the user has made changes to the current image and clicks on any of the 
  589. file buttons (1 through 5), GREDA will save the current record to disk 
  590. automatically if the user has specified "Auto Save = Y" in the 
  591. configuration.  Otherwise, the program will prompt the user to save this 
  592. record to disk.
  593.  
  594. ────────────────────────────────────────────────────────────────────────────
  595. File Buttons
  596. ────────────────────────────────────────────────────────────────────────────
  597.  
  598. There are six buttons that are related to file and record position.  These 
  599. buttons are laid out at the top of the display:
  600.  
  601.  1 - File Open/Create             Designate a file name for editing or
  602.                                   create a new file.
  603.  
  604.  2 - First Image Record           Move the record pointer to the first
  605.                                   image in the file.
  606.  
  607.  3 - Previous Image Record        Move the record pointer to the image
  608.                                   previous to one currently displayed.
  609.  
  610.  4 - Next Image Record            Move the record pointer to the image
  611.                                   after the one currently displayed.
  612.  
  613.  5 - Last Image Record            Move the record pointer to the last
  614.                                   image in the file.
  615.  
  616.  6 - Current Image Record Number  Display the current image number only.
  617.  
  618. ────────────────────────────────────────────────────────────────────────────
  619. Menu Buttons
  620. ────────────────────────────────────────────────────────────────────────────
  621.  
  622. The menu buttons are located on the left side of the display and are 
  623. distributed 2 across and 8 vertically.  The menu buttons do not include the 
  624. search and current color buttons (23 and 24).
  625. GREDA User's Guide                                          Page: 11
  626.  
  627.  
  628.  7 - Help                         Display information about each menu
  629.                                   button.
  630.  
  631.  8 - Record                       Record retrieve, save, insert, and delete.
  632.  
  633.  9 - Pen                          Selects the pen drawing device.  If the
  634.                                   pen is current, the program receives
  635.                                   input to define the height and width of
  636.                                   the drawing point.
  637.  
  638. 10 - Text                         Text entry onto image.  The user may
  639.                                   choose one of 4 different font heights and
  640.                                   options for shadow and color phase.
  641.  
  642. 11 - Shapes                       Line draw, ellipse, rectangle, and
  643.                                   polygons can be generated with a variety
  644.                                   of options such as color phase, fill, and
  645.                                   starburst (ellipses only).  The rectangle
  646.                                   drawing function can generate a Brownian
  647.                                   vertical or horizontal motion.  This is
  648.                                   commonly used in generating fractal
  649.                                   landscapes.
  650.  
  651. 12 - Spray                        Select the spray drawing device.  Spray
  652.                                   is generated using random numbers and the
  653.                                   current paint color.  If the spray is the
  654.                                   current drawing device, the program
  655.                                   receives input defining the height, width,
  656.                                   and spray rate.
  657.  
  658. 13 - Color Palette                Color palette editor, allows the user to
  659.                                   change 239 of the 256 colors available.
  660.  
  661. 14 - Region Fill                  Fills areas of the current image with
  662.                                   color, step and repeat, and schemes.
  663.  
  664. 15 - Size, Rotation, Flip         Resize, rotate, or flip the image frame
  665.                                   vertically or horizontally.
  666.  
  667. 16 - Move Image Area              Shift the image area up, down, left, or
  668.                                   right.
  669.  
  670. 17 - Magnification                Set the editing size to 1, 2, or 4 times
  671.                                   the actual image size.
  672.  
  673. 18 - Tools                        Various tools and utilities for GREDA
  674.                                   configuration, erasing and filling the
  675.                                   image frame, releasing buffers, and
  676.                                   functions to export the image and color
  677.                                   palette data to C source code.
  678.  
  679. 19 - Replay                       Use this function to view an animated
  680.                                   sequence.
  681.  
  682. GREDA User's Guide                                          Page: 12
  683.  
  684. 20 - Block Menu                   Functions for block and copy, erase,
  685.                                   fill, generate color phase, extract
  686.                                   copy buffer to file.
  687.  
  688. 21 - View                         View the current image frame at 1:1 with
  689.                                   the option of moving around in front of
  690.                                   a chosen background.
  691.  
  692. 22 - Exit                         Quit GREDA and exit to DOS.  The program
  693.                                   warns the user of any changes made to
  694.                                   the image and color palette and allows
  695.                                   the user to save them to file.
  696.  
  697. ────────────────────────────────────────────────────────────────────────────
  698. Color Buttons
  699. ────────────────────────────────────────────────────────────────────────────
  700.  
  701. The color buttons are located across the bottom the display.  The program 
  702. displays the available colors on the color bar (27).  The user may select a 
  703. color from the color bar or may pick a color from the current image by 
  704. pressing the right mouse button.
  705.  
  706.  
  707. 23 - Search Color                 The color to search for in any search
  708.                                   and replace operation.
  709.  
  710. 24 - Current Color                The current paint color.  If the user
  711.                                   clicks on this button, the program
  712.                                   redisplays the color bar (27) at the
  713.                                   same offset that the color was selected.
  714.  
  715. 25 - Previous 8 colors            Shifts the color bar eight colors to the
  716.                                   left.
  717.  
  718. 26 - First 56 Colors              Displays the color bar beginning with the
  719.                                   first 56 colors.
  720.  
  721. 27 - 56 of 256 Available Colors   The color bar displays 56 of the 256
  722.                                   colors.  The user can select a color by
  723.                                   moving the mouse cursor to a displayed
  724.                                   color and click the left mouse button.
  725.  
  726. 28 - Next 8 Colors                Shifts the color bar eight colors to the
  727.                                   right.
  728.  
  729. 29 - Last 56 Colors               Displays the color bar beginning with the
  730.                                   last 56 colors.
  731.  
  732. ────────────────────────────────────────────────────────────────────────────
  733. Image Positioning
  734. ────────────────────────────────────────────────────────────────────────────
  735.  
  736. If the frame size at the current magnification exceeds the size of the image 
  737. area, GREDA will display image positioning buttons as needed for the 
  738. vertical and horizontal.  Double arrows indicate positioning at the 
  739. beginning or end, and single arrows indicate shifting the image by eight 
  740. pixels in that direction.
  741. GREDA User's Guide                                          Page: 13
  742.  
  743.  
  744. ────────────────────────────────────────────────────────────────────────────
  745. Color Palette Editor
  746. ────────────────────────────────────────────────────────────────────────────
  747.  
  748. To edit the current color palette, move the mouse cursor to the menu button 
  749. with the picture of a painter's palette (button number 13) and click the 
  750. left mouse button.  The program will display the color palette editor.  Upon 
  751. entering the editor the current selected color (2) will be the same as the 
  752. current paint color that was selected while in the image editor (button 
  753. number 24).  Color numbers 1 - 16 and 256 are reserved and cannot be changed 
  754. by the user.
  755.  
  756. ┌──┬──┬──┬──┬──┬──┬──┬──┬──┬──┬──┬──┬──┬──┬──┬──┐┌────────────────────────┐
  757. │1.│  │  │  │  │  │  │  │  │  │  │  │  │  │  │  ││3.                      │
  758. ├──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┤│                        │
  759. │  │  │  │  │  │  │  │  │  │  │  │  │  │  │  │  ││                        │
  760. ├──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┤│                  Blu   │
  761. │  │  │  │  │  │  │  │  │  │  │  │  │  │  │  │  ││                        │
  762. ├──╔══╗──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┤│  Red            ▓▓▓▓▓▓ │
  763. │  ║2.║  │  │  │  │  │  │  │  │  │  │  │  │  │  ││                 ▓▓▓▓▓▓ │
  764. ├──╚══╝──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┤│ ░░░░░░   Grn    ▓▓▓▓▓▓ │
  765. │  │  │  │  │  │  │  │  │  │  │  │  │  │  │  │  ││ ░░░░░░          ▓▓▓▓▓▓ │
  766. ├──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┤│ ░░░░░░  ▒▒▒▒▒▒  ▓▓▓▓▓▓ │
  767. │  │  │  │  │  │  │  │  │  │  │  │  │  │  │  │  ││ ░░░░░░  ▒▒▒▒▒▒  ▓▓▓▓▓▓ │
  768. ├──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┤├────────────────────────┤
  769. │  │  │  │  │  │  │  │  │  │  │  │  │  │  │  │  ││4.▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  770. ├──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┤│ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  771. │  │  │  │  │  │  │  │  │  │  │  │  │  │  │  │  ││ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  772. ├──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┤└────────────────────────┘
  773. │  │  │  │  │  │  │  │  │  │  │  │  │  │  │  │  │┌────────────────────────┐
  774. ├──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┤│5.                      │
  775. │  │  │  │  │  │  │  │  │  │  │  │  │  │  │  │  ││   Trend Start:         │
  776. ├──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┤├────────────────────────┤
  777. │  │  │  │  │  │  │  │  │  │  │  │  │  │  │  │  ││6.                      │
  778. ├──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┤│    Trend Stop:         │
  779. │  │  │  │  │  │  │  │  │  │  │  │  │  │  │  │  │├────────────────────────┤
  780. ├──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┤│7.                      │
  781. │  │  │  │  │  │  │  │  │  │  │  │  │  │  │  │  ││     Generate Trend     │
  782. ├──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┤├────────────────────────┤
  783. │  │  │  │  │  │  │  │  │  │  │  │  │  │  │  │  ││8.                      │
  784. ├──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┤│     Restore Colors     │
  785. │  │  │  │  │  │  │  │  │  │  │  │  │  │  │  │  │├────────────┬───────────┤
  786. ├──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┼──┤│9.          │10.        │
  787. │  │  │  │  │  │  │  │  │  │  │  │  │  │  │  │  ││    Keep    │  Cancel   │
  788. └──┴──┴──┴──┴──┴──┴──┴──┴──┴──┴──┴──┴──┴──┴──┴──┘└────────────┴───────────┘
  789. ┌─────────────────────────────────────────────────────────────────────────┐
  790. │11.                                                                      │
  791. │ Color No:            Red:            Green:            Blue:            │
  792. └─────────────────────────────────────────────────────────────────────────┘
  793.  
  794. GREDA User's Guide                                          Page: 14
  795.  
  796. ┌───────────────────────────┐
  797. │Color Palette              │
  798. └───────────────────────────┘
  799.  
  800.  1 - 256 Colors (1 - 16 and 256 are reserved)
  801.  2 - Current Selected Color
  802.  
  803. ┌───────────────────────────┐
  804. │RGB Values                 │
  805. └───────────────────────────┘
  806.  
  807.  3 - Bar Chart Color Values
  808.  4 - Current Color Patch
  809.  
  810. ┌───────────────────────────┐
  811. │Menu Buttons               │
  812. └───────────────────────────┘
  813.  
  814.  5 - Trend Start
  815.  6 - Trend Stop
  816.  7 - Generate Trend
  817.  8 - Restore Colors
  818.  9 - Keep
  819. 10 - Cancel
  820.  
  821. ┌───────────────────────────┐
  822. │Color Value Status         │
  823. └───────────────────────────┘
  824.  
  825. 11 - Current Color Status
  826.         Color No
  827.         Red
  828.         Green
  829.         Blue
  830.  
  831. ────────────────────────────────────────────────────────────────────────────
  832. ┌───────────────────────────┐
  833. │Editing Colors             │
  834. └───────────────────────────┘
  835.  
  836. You can edit a single color at a time or generate a color "trend".  To edit 
  837. a single color, move the mouse cursor to the color you want to edit and 
  838. press the left mouse button.  The program will move the highlight box (2) to 
  839. the color.  The values of red, green, and blue will be displayed in the 
  840. value box (3), a patch of that color will be displayed in 4, and 11 will 
  841. display the color number and the actual values for red, green, and blue 
  842. (RGB).
  843.  
  844. To change the RGB values, move the mouse cursor into the value box (3) to 
  845. the color bar (red, green, or blue) that you want to change.  Click the left 
  846. mouse button to adjust the amount of each RGB value.  While holding the left 
  847. mouse button down, the user can move the mouse vertically to adjust the RGB 
  848. values.  The new color will be displayed in the color patch (4), in the 
  849. currently selected color box (2), and the values displayed in the status box 
  850. (11).
  851.  
  852. GREDA User's Guide                                          Page: 15
  853.  
  854. To restore a single color to the same RGB values as assigned before entering 
  855. the palette editor, move the mouse cursor to that color and click the right 
  856. mouse button.
  857.  
  858. ┌───────────────────────────┐
  859. │Generating a Color Trend   │
  860. └───────────────────────────┘
  861.  
  862. Color trends are several colors in sequence that display a smooth range of 
  863. color values such as black to blue.  The starting color (black) will contain 
  864. zero amounts of RGB values.  Each color in sequence will use a slightly 
  865. higher percentage of blue until it reaches the target (Trend Stop) value.
  866.  
  867. Move the mouse cursor to a color and press the left mouse button.  GREDA 
  868. will make that the current color.  Then move the mouse cursor to the "Trend 
  869. Start" menu item and click the left mouse button.  The program will display 
  870. the color number on the menu.  You may edit the RGB values of this color to 
  871. your taste.  Now move the mouse cursor the color that you want to designate 
  872. as the last color in the sequence and press the left mouse button.  GREDA 
  873. will make this the current color.  Now move the mouse cursor to the "Trend 
  874. Stop" menu item and click the left mouse button.  The program will display 
  875. the color number on the menu.  You may edit the RGB values.  Now move the 
  876. mouse cursor to the "Generate Trend" menu item and click the mouse left 
  877. button.  GREDA will change the RGB values of each color to generate a smooth 
  878. change from the start to stop values.
  879.  
  880. ┌───────────────────────────┐
  881. │Restore Colors             │
  882. └───────────────────────────┘
  883.  
  884. At any time, the user may restore the color palette to the values before 
  885. entering the palette editor by clicking on the "Restore Colors" button.
  886.  
  887. ┌───────────────────────────┐
  888. │Keep Colors                │
  889. └───────────────────────────┘
  890.  
  891. When the colors are acceptable, move the mouse cursor to the "Keep" menu 
  892. item and click the left mouse button.  The program will keep those colors as 
  893. the current color palette.  The user may edit these colors again and again.  
  894. To save these colors in a palette file, from the main menu click on the 
  895. color palette menu item (see Screen Layout, button number 13).  Then select 
  896. "Save Palette" from the menu.
  897.  
  898. ┌───────────────────────────┐
  899. │Cancel Colors              │
  900. └───────────────────────────┘
  901.  
  902. If the changes you have made are unacceptable and you want to return to the 
  903. image editor, move the mouse cursor to the "Cancel" menu item and click the 
  904. left mouse button.  The colors will be restored to the values prior to 
  905. entering the palette editor and the program will return to the image editor.
  906.  
  907. GREDA User's Guide                                          Page: 16
  908.  
  909. ────────────────────────────────────────────────────────────────────────────
  910. Acknowledgements
  911. ────────────────────────────────────────────────────────────────────────────
  912.  
  913.        IBM is trademark of International Business Machines
  914.    Gateway is a trademark of Gateway Corporation
  915.        ATT is a trademark of American Telephone and Telegraph Corporation
  916.     PC-DOS is copyrighted software from IBM
  917.     MS-DOS is copyrighted software from Microsoft Corporation
  918. PaintBrush is copyrighted software from Microsoft Corporation
  919.    Windows is copyrighted software from Microsoft Corporation
  920.   256Paint is copyrighted software from Pod Bay Enterprises
  921.  
  922.